Row Expander
Description
Once your grid separated into different groups, you might want to add the ability to expand and contract those groups. This might allow users to move through the records in your grid in your more quickly and can free up space on the screen. This section allows you to design the Row Expander in your grid and how you want it to look and operate.
Discussion
The row expander is a method to show information related to a record on a row. A column is added with a 'plus' icon that can be selected to 'expand the row'. A minus icon will be shown after the row is expanded that can be selected to close the expanded row. There are 2 row expander types.
The 'LinkedGrids' option allows selecting one or more grid components that can be linked to the current record in the row. The linked grids can be shown in tabs, or an accordion control.
The 'CustomEvent' will cause the grid event 'OnExpandRow' to fire. This event sets a number of properties such as e.html and e.javascript. The contents of the expanded row will be set to e.html. If the e.javascript is not null, the javascript contained in this property will be executed. There are other optional properties available to allow a developer to create a custom display that can be linked to the current record.
Multiple records can have their row expanded, allowing the user to view additional information about multiple records.
If the 'Mode' property is set to 'Single', then only one row can be expanded at a time. If a row is expanded and you expand another row, the currently expanded row will be collapsed.
- Name
- Description
- Has row expander
The row expander is another method to show information related to a record on a row. A column is added with a 'plus' icon that can be selected to 'expand the row'. A minus icon will be shown after the row is expanded that can be selected to close the expanded row. There are 2 row expander types.
- Mode
The Mode property determines how the action expanding one row affects the other rows in a grid. If the 'Mode' property is set to 'Single', then only one row can be expanded at a time. If a row is expanded and you expand another row, the currently expanded row will be collapsed. Multiple records can have their row expanded, allowing the user to view additional information about multiple records.
- Auto-expand first row
Specify if the first row in the Grid should be automatically expanded when the Grid is loaded.
- Row expander type
The ' LinkedGrids ' option allows selecting one or more grid components that can be linked to the current record in the row.
- Row expander linked Content
If you selected the 'LinkedContent' option under the Row expander type property then this is where you define what the row links to.
- Working message
Specify the text to display in the row expander while the ajax callback is being computed.
- Auto-refresh on expand
By default, an Ajax callback is made when the row expander for a given row is opened the first time, but not when it is closed and then is opened the second and subsequent times. If you check this property, an Ajax callback will be made every time the row expander for a given row is expanded.
- Row expand method
Making the Grid Behave Like an Accordion. Using the 'Row expand method' property, you can make a Grid component behave like a data driven Accordion Control.
- Icon bubble help
Icon bubble help lets you add help bubbles that appear whenever a user hovers over the row expander's expand/contract icon. The default setting is no help bubble.
- Animate
The Animate property in the Row Expander section of the Grid Builder allows you to set animation options for a row expander when it opens and closes. Simply check the 'Animate' property checkbox to turn on Animation. When you do this an Animation options property will open. This will allow you to choose how you want the row expander animation to appear to the user.
- Animation Options
Clicking the button [dot_img] to the right of the Animation Options property will open the Animation Options dialog.